home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 501-525 / disk_511 / dirwork / dw.doc < prev    next >
Text File  |  1992-05-06  |  32KB  |  831 lines
  1.  
  2.     DirWork V1.31 - Chris Hames 22/6/91.  All rights Reserved.
  3.     ----------------------------------------------------------
  4.             DW Size 44428 bytes
  5.  
  6.     Need to get around your directories fast and simply.  Force yourself
  7. to read fully this doc file and I think you will find this program of great
  8. use.  What makes DirWork better than the rest ?
  9.  
  10.     VERY Configurable.  All Buttons/Options/WindowSize/WindowPosition
  11.     can be modified and the DW executable modified to have these values.
  12.  
  13.     Detaches.  So when you type DW from CLI you can still use your
  14.     CLI as if nothing happened.  No need to Run!
  15.  
  16.     Sleep. Can be put to sleep so it disappears completely until you
  17.     select it from the workbench tools menu (kick2.0-) or press left
  18.     Ctrl-Shift-Alt-D or whatever keys you configure it to.
  19.     Also can be started in sleep mode so "DW -s" in your
  20.     startup-sequence will have it there for when you want it later.
  21.  
  22.     Intelligent.  Double click the left mouse button on filename of a
  23.     IFF picture and it will be automatically displayed.  Double click
  24.     a text file to type it, press the right mouse button to edit it!
  25.     Double Click a .lzh file and you see the contents, right mouse
  26.     button on one extracts the contents to the destination dir and then
  27.     reads in the new entries.
  28.     As well as many other instant actions on different types of files.
  29.  
  30.     A excellent show built in that loads in the next picture while your
  31.     looking at the last.  You can of course set up a button to use your
  32.     own show utility.
  33.  
  34.     Both memory and BootBlock virus checking.
  35.  
  36.     PopKeys.  Define keys to start up programs. eg make Amiga-P start
  37.     your paint program.  Amiga-Escape start a NewShell etc etc etc
  38.     Also adds these programs to your Tools menu if using Kick2.0-.
  39.  
  40.     ScreenBlanker so that the phosphors on your monitor get a rest.
  41.  
  42.     AutoPoint option so that the window the mouse is over is selected.
  43.  
  44.     Copy & move cloning so that the date/protection/filenote is same.
  45.  
  46.     Fast and Smooth Floppy Dirs!  Getting a directory off a floppy
  47.     is up to 2 times faster.  And your drive doesn't grind back and
  48.     forward anywhere near as much as normal.
  49.  
  50.     Size.  At less than 45K uncompressed in makes mince meat of most
  51.     of those huge memory hungry utils.
  52.  
  53.  
  54. This program is SHAREWARE so please support the work that has gone into it.
  55. Here is my order of preference due to bank charges for contributions :-
  56.     Australian Cash or Cheque
  57.     Internationa Money Order or anything else that costs me nothing
  58.     Foreign Cash (US, English or German prefered)
  59. The suggested contribution of $35 will get you a disk containing the next
  60. version of this program when it is available.  
  61. Please send the contribution & any ideas etc to:-
  62.     C Hames           |Internet:
  63. Snail:    6 Pamela Crt      |   bytey@phoenix.pub.uu.oz.au
  64.     Blackburn South   |   ins760z@monu4.cc.monash.edu.au (1991 only)
  65.     VIC 3130          |FidoNet BBS:
  66.     Australia         |   3:633/353
  67. And don't forget to include the version number you have!
  68.  
  69. This program may be copied as long as it is accompanied by this doc file
  70. both unaltered & no money is charged(except for a reasonable copying fee
  71. such as what Fred Fish charges).  All use of this program is at your own
  72. risk & I assume no responsibility or liability for any problems that occur.
  73.  
  74. Future Improvements:- (When registering please tell me which ones you want)
  75.     More configurable. ie Screens/ButtonPositions/Colors/Priority etc
  76.     Much better Type/Htype.
  77.     Ability to stop during a dir read.
  78.     Iconify.
  79.     Inbuilt gif viewer(I have written one just needs adding).
  80.     Internal Diskcopying/Formatting.
  81.     More file types recognized.
  82.     Last side used as source, selection option.
  83.     Faster(the need for speed!).
  84.  
  85.  
  86. History:-
  87.     27/ 1/90 1.00    First Release.
  88.      5/ 2/90 1.01    VMK updated to v27.  Stopped title bar flashing.
  89.     12/ 2/90 1.02    Icon. Faster. Smaller. Now uses less memory(5K) if
  90.             destination display is not used.
  91.     15/ 2/90 1.03    Detaches from CLI.  Some Workbench problems fixed.
  92.             A Show bug fixed.
  93.     22/ 2/90 1.04    CD bug fixed.  Volumes button added.  Dir buttons
  94.             and options can be modified and saved.  VMK can
  95.             now automatically be executed every 10 secs.
  96.     14/ 7/90 1.10    Heaps of little improvements. Copy/Delete/Move Dirs.
  97.             Now VERY configurable buttons. Sleep. Window sizing.
  98.             HxType/Type/Search Esc works anytime now. Rename/
  99.             makdir/copy/move/delete add or remove from both
  100.             filelists where appropriate.  So many more changes
  101.             that I am calling it 1.10 !
  102.     30/ 7/90 1.11    Bug fixed when getting dirs with spaces in them.
  103.     17/ 8/90 1.12    Rare problem getting dirs with spaces at end.
  104.     10/ 1/91 1.20    More than 255 files displayed.
  105.             Dirs above files option added.
  106.             And too many other things to mention.
  107.     13/ 1/91 1.21    Sometimes crashed when started from cli,
  108.             bug found in detach routine. Argh!!
  109.             Display .info files option added.
  110.             Window Pos now saved with config.
  111.     16/ 1/91 1.22    Recognition of text files improved. Other little
  112.             things improved.
  113.     10/ 6/91 1.30    Wouldn't save config if started in sleep mode (-s)
  114.             fixed.  Didn't open some windows at same offset as
  115.             window fixed.  Now gets the dirs after sleep.
  116.             Automatically gets info(bytes free) for dirs after
  117.             a copy move or delete. MakeDir can have icon.
  118.             Bootblock checking.  Popkeys.  ScreenBlanking.
  119.             Runs programs with spaces(Dave!).
  120.             Save's path of DW program with save executable.
  121.             Paths other than C: recognized(Thanks Randell).
  122.             Parent/root far left or right of the text gadget
  123.             right mouse button over text gadget gets dir.
  124.             Shells etc now have close gadgets if kick 2.0,
  125.             and the N,x,u commands have been improved.
  126.             Kick 2.0 looks. Heaps of other little things.
  127.     22/ 6/91 1.31    Requester kick 1.2/1.3 freeze bug hopefully gone.
  128.             Crash after RMB instant getdir gone.
  129.             AutoPoint for James.  Screen option.
  130.             Copy/move clone code better and kick 1.2/1.3 date.
  131.             Filenote problem with FSDirs problem fixed.
  132.             Better FileSelection. Requester bigger.
  133.             FileBits/Note writting under Kick 1.2/1.3 fixed.
  134.             Resizing doesn't make slide gadgets go to top.
  135.             Kick 2.0- execute window title shows path.
  136.             Delete didn't request for non-empty dirs fixed.
  137.             Popkey stuff gets added to tools menu in Kick2.0-
  138.             No flashing bottom line.
  139.             And some other little things.
  140.  
  141. Instructions:-
  142. ------------
  143. The window display
  144.   +--------------------------------------------------------------------+
  145.   |+|  Title Bar - Chip & total memory available                   | | |
  146.   |--------------------------------------------------------------------|
  147.   |  +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++   |
  148.   |  +++ Buttons +++ +++ +++ +++ +++ Buttons +++ +++ +++ +++ +++ +++   |
  149.   |  +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++ +++   |
  150.   /   Left Directory    Al No CD << <> >> CD No Al Right Directory     /
  151.   |--------------------------------------------------------------------|
  152.   | Left File List                | || |        Right File List        |
  153.   |                               |S||S|                               |
  154.   | DirectoryName          ?      |l||l| DirectoryName          ?      |
  155.   |    OR                         |i||i|    OR                         |
  156.   | FileName               ?  size|d||d| FileName               ?  size|
  157.   |                        ^      |e||e|                        ^      |
  158.   |         if undeletable u      | || |         if undeletable u      |
  159.   |        if has filenote f      |G||G|        if has filenote f      |
  160.   |           if is script s      |a||a|           if is script s      |
  161.   |                if pure p      |d||d|                if pure p      |
  162.   |                               |g||g|                               |
  163.   |                               |e||e|                               |
  164.   |                               |t||t|                               |
  165.   |                               | || |                               |
  166.   |--------------------------------------------------------------------|
  167.   |Errors and other messages     Disk Names & Bytes Free as well       |
  168.   +--------------------------------------------------------------------+
  169.  
  170. Actual directory text (Left Directory or Right Directory)
  171.  
  172.     Pressing the Right mouse button when over the text showing the path
  173.     of the dir reads that directory into the file list.
  174.     eg If DF0: was in the Left Directory text gadget you could insert
  175.        a new disk into the internal disk drive DF0: and then press the
  176.        right mouse button over the DF0: in the Left directory text to
  177.        read in the new directory.
  178.  
  179.     Pressing the left mouse button over the far left/right of the text
  180.     gadget(see the "/" in window representation above) gets the parent.
  181.     Parent makes DF0:t/r become DF0:t
  182.     Right button gets the root. Root makes DF0:t/r become DF0:
  183.  
  184.     You can press the left mouse button over the left or right directory
  185.     text gadget then edit the directory to the one you want to work with
  186.     and then if you press return the directory will be read in.
  187.  
  188.     Remember in most string gadgets right Amiga X clears the text in
  189.     the gadget, and you can use shift -> or <- to go to end or start
  190.     of the text.
  191.  
  192.  
  193. FileList(s)
  194.  
  195.     Press the left mouse button to select/deselect a file or directory
  196.     name.
  197.  
  198.     Right mouse button or double click left button on a directory reads
  199.     in that directory.
  200.  
  201.     Left mouse button to the far left or right of a file/dir will
  202.     bring up a requester with the FileNote and Protection bits which
  203.     you can edit.
  204.  
  205.     Use the slide gadget to see files that are not displayed.
  206.  
  207.     Double Click of left Button on a file will try to recognize the file
  208.     and automatically do something with the file(eg With default settings
  209.     the quickly double clicking the left button on a text file will type
  210.     it & and double clicking on a IFF picture(such as a picture from a
  211.     paint program) file will show it with the internal show).
  212.  
  213.     Right Mouse Button on a file will try to recognize the file and
  214.     automatically do something with the file.
  215.     eg With default settings the Right mouse button on a text file will
  216.        edit it (If you have configured your instant edit to your editor
  217.        or it already is) or pressing the right mouse button on a picture
  218.        file will show it with Mostra(© Sebastino Vigna) if you have that
  219.        program.
  220.  
  221. Here is a table of the default instant Operations:-
  222.  
  223. File type    Double Clicking            Right Mouse button
  224. ----------------------------------------------------------------------------
  225. MOD.        Intuitracker filename        Run Intuitracker filename
  226. .ARC        Arc v filename            Arc xw filename
  227. .DMS        DMS Write filename        DMS Write filename
  228. .LZH        Lharc l    filename        Lharc -m -x -r x filename
  229. .LHW        Lhwarp Write 0 filename        Lhwarp Write 0 filename
  230. .PAK        filename            filename
  231. .WRP        UnWarp filename            UnWarp filename
  232. .ZIP        PkaZIP filename            PkaZIP filename
  233. .ZOO        Zoo v filename            Zoo xO// filename
  234. .GIF        VirtGIF filename        Run >NIL: VirtGIF filename
  235. .INFO
  236. 8SVX        INTERNAL PlaySS filename    PlaySS filename
  237. ANIM        ShowANIM >NIL: filename        ShowANIM >NIL: filename
  238. ILBM        INTERNAL Show filename        Mostra >NIL: filename
  239. SMUS        PlaySMUS >NIL: filename        PlaySMUS >NIL: filename
  240. FTXT
  241. Most        Most filename            Run >NIL: Most filename
  242. PP20        PPMore filename            PPShow filename
  243. Exect                        filename
  244. Text        INTERNAL Type filename        Run >NIL: E filename
  245. Binry        INTERNAL HxType filename    Run >NIL: NewZAP filename
  246.  
  247.  
  248. Buttons
  249.     The main idea is to press the left mouse button if you are referring
  250.     to the source as the file list below the pointer.  So to copy from
  251.     the left file list to the right list, click on the the left copy
  252.     button.  And to copy from the right file list to the left file list,
  253.     click on the right copy button.
  254.  
  255.     You can also click on a button with the right mouse button to refer
  256.     to the opposite file list but if this sounds confusing just ignore
  257.     this paragraph.
  258.     (eg Left button on left DF0: will get the directory from DF0:
  259.     and put it in the left file list, but right button on left DF0: will
  260.     get the directory DF0: and put it in the right file list)
  261.  
  262.     Below is a description of what the buttons will do when the default
  263.     setup is used.  You can modify button functions to do something
  264.     completely different if you want.
  265.  
  266.     DF0: DF1: RAM: SYS: etc
  267.         Just press these to get the directory of this name in the
  268.         file list below the pointer.
  269.  
  270.     Sleep    Puts the task to sleep until you press the four left keys
  271.         Ctrl-Shift-Alt-D.  ie The window disappears as if you quit
  272.         but the program is still there waiting until you press the
  273.         keys.  So you don't have to load DirWork all the time.
  274.         DirWork starts in Sleep mode if you type DW -s instead of
  275.         the usual DW when you run it from CLI.  So you can have the
  276.         command DW -s in your startup-sequence then when you 
  277.         actually want DirWork later you just have to press the keys
  278.             Ctrl-Shift-Alt-D or if running Kick2.0- just can select DW
  279.         in the Tools menu of workbench.
  280.         Do what you want then press the sleep button to make DirWork
  281.         disappear again.  See PopKeys information for how to change
  282.         the key combination that wakes DirWork up.
  283.  
  284.     Volms    Displays all things assigned ie C: LIBS: SYS: etc
  285.         Just press a button on one of them to enter the directory.
  286.  
  287.     Al    Select all files.
  288.  
  289.     No    Unselect all files & dirs.
  290.  
  291.     <>    Swaps the left and right file list displays.
  292.  
  293.     >> & <<    Copies one file list to the other file list.
  294.  
  295.     Info    Updates the info(bytes Free and name). And displays how many
  296.         dirs/files/bytes are selected.  Good to see if you are going
  297.         to be able to fit all the file you want to copy.
  298.  
  299.     Copy    Copys files/dirs from one dir to another.
  300.         BytesFree for the source/destination is updated.
  301.         See the configuration section if you want it to clone
  302.         the original date/filenote/protection etc.
  303.  
  304.     Move    Moves files/dirs from one dir to another.
  305.         BytesFree for the source/destination is updated.
  306.         See the configuration section if you want it to clone
  307.         the original date/filenote/protection etc.
  308.         Please note the DOS 1.2/1.3 bug where you lose directories
  309.         if you move a directory to be a child of itself.  I
  310.         intercept and stop some but not all.
  311.         ie Move ONE ONE/ONE  !!!!IS NOT A GOOD IDEA!!!!
  312.  
  313.     Delet    Delete files/dirs.  You are prompted before non empty dirs
  314.         are deleted for confirmation but see the configuartion
  315.         section if you don't like this.
  316.         BytesFree for the directory is updated.
  317.  
  318.     Print    Copies selected files text to the printer.
  319.  
  320.     Renam    Rename files/dirs.  Edit names in the requester.
  321.         Please note the DOS 1.2/1.3 bug where you lose directories
  322.         if you move a directory to be a child of itself.  I
  323.         intercept and stop some but not all.
  324.         ie Rename ONE ONE/ONE  !!!!IS NOT A GOOD IDEA!!!!
  325.  
  326.     MakDi    Make a new directory. Enter name in requester.
  327.         See the configuration section if you want it to also create
  328.         a icon for the directory.
  329.  
  330.     Prote    Change delete protection of a file/dir.  Lets you toggle
  331.         the delete protection of a file.  A file with delete
  332.         protection on has a u next to the right of the filename.
  333.  
  334.     CD    Makes the dir the current directory.
  335.  
  336.     Type    Displays a text file to a window.  Esc quits anytime.
  337.         By default a double click on a text file will call this
  338.         routine.
  339.  
  340.     HxType    Displays a file in hexadecimal to a window.
  341.         By default Double click on a binary file will call this
  342.         routine.
  343.  
  344.     Instant    This performs as if you double clicked the left mouse button
  345.         on the selected files.  It will perform a relevent button
  346.         on the file if it finds one otherwise it will assume the
  347.         file is just binary and HxType it.  All these things can
  348.         be changed, see configuaration section
  349.  
  350.     Show    Shows IFF files.  Loads in the next pic while the last
  351.         is being displayed to save a lot of time.  Use Cursor keys
  352.         to scroll around a picture bigger than the screen. Use the
  353.         left mouse mouse button or press a key to go to next.
  354.         If low on memory select one file at a time to display.
  355.         By default a double click on a IFF picture file will call
  356.         this routine.
  357.  
  358.     PlaySS    Plays any file as a Sampled sound at 10000 samples/sec.
  359.         By default a double click on a 8SVX sound file will call
  360.         this routine.
  361.  
  362.     Search    Search files for text that you are prompted for.
  363.         The prompt has a UpperCase!=LowerCase option.
  364.         It will tell you at want offsets in the file the text is
  365.         found.
  366.  
  367.     VMK    My MEMORY virus detector/killer.
  368.         For a simple check to see that your memory is virus free.
  369.         Does checks of many memory locations etc that are used
  370.         by viruses.  If you get a alert use a good disk virus killer
  371.         to clear up the problem.  See the seperate program VMK v1.0
  372.         for docs.
  373.  
  374.  
  375.     The following buttons require you to have a external program and/or
  376.     run in your c: or similar directory.
  377.  
  378.     Prefs    Loads up workbench preferences with kickstart 1.2/1.3.
  379.         Requires Preferences to be in a command path such as c:.
  380.         Kickstart 2 preferences are spread over a few programs so
  381.         there isn't one program you can run.
  382.  
  383.  
  384.     Edit    Edit selected files. Requires a editor named E in a path
  385.         such as c:.
  386.         Pressing the right mouse button on a text file will call
  387.         a simlar routine.
  388.  
  389.     NewZP    NewZAP selected files. Requires Newzap in a path such as c:.
  390.         NewZAP is a file editor © John Hodgson.
  391.         By default pressing the right mouse button on a binary file
  392.         will call a similar routine.
  393.  
  394.     Run    Run selected files.  You will be prompted for optional
  395.         arguments. eg if you selected the file Diskcopy you
  396.         might want to enter "DF0: to DF1:".
  397.         By default pressing the right mouse button on a executable
  398.         file will will call a similar routine.
  399.  
  400.     Commd    Enter commands in the cli window then enter endcli to
  401.         return to DW or if using Kick2.0- or later click the close
  402.         gadget.
  403.  
  404.     NewSh    Does the NewShell command.  Requires all shell type files.
  405.  
  406.     LHarcA    Adds file to a Lharc archive that you specify in the prompt.
  407.  
  408.     Xoper    Starts the program Xoper © Werner Gunther. Requires Xoper to
  409.         be in path such as C:.
  410.  
  411.  
  412. Changing the configuration
  413. --------------------------
  414. Menu Options
  415.  
  416.     Move the mouse pointer up to the left side of the title bar of the
  417.     window and press the right mouse button.
  418.  
  419.  
  420.     You can select if you want every inserted floppy disk's boot block
  421.     checked to see if it is normal.  Note some bootblocks are not normal
  422.     and are not viruses so when you insert a disk and get the requester
  423.     saying this is not a normal bootblock only install if you know that
  424.     the bootblock does not contain important information.
  425.     This is defaulted to off.
  426.  
  427.  
  428.     You can select if you want VMK(The virus detector) to be run every
  429.     8 seconds.  You get a requester asking for options(see VMK docs).
  430.     This is defaulted to off.
  431.  
  432.  
  433.     You can select if you want the screen to blank after 8 minutes of
  434.     no activity by the user.  A still image on a monitor is not good for
  435.     it so this blanks the screen.
  436.     This is defaulted to off.
  437.  
  438.  
  439.     AutoPoint lets you select if you want the window under the pointer
  440.     to be automatically selected(activated).
  441.     This is defaulted to off.
  442.  
  443.  
  444.     You can select whether you want Fast&SmoothFloppyDirs.
  445.     This is defaulted to off shouldn't be needed with Kick 2.0-.
  446.     Note that the DirWork FSDirs does not make use of dos buffers that
  447.     have been added using AddBuffers, but does very well with the two
  448.     commercial diskbuffering programs.
  449.  
  450.  
  451.     You can select if you want Directories displayed above files.
  452.     This is defaulted to off.
  453.  
  454.  
  455.     You can select if you want .info files to be displayed.
  456.     This is defaulted to on.
  457.  
  458.  
  459.     You can select if you want the close gadget box of the window
  460.     to make dirwork sleep instead of quit.
  461.     This is defaulted to off.
  462.  
  463.  
  464.     You can select if you want the old style button selection where
  465.     the button position is irrelevent.  ie Where you must use the
  466.     right mouse button to refer to the right hand file list as the
  467.     source.  If you don't understand just ignore this option.
  468.     This is defaulted to off.
  469.  
  470.     You can select that DirWork is to have a screen of its own instead
  471.     of using the workbench screen.
  472.     This is defaulted to off.
  473.  
  474.  
  475.     ChangePopKey allows you to change the keys that bring DirWork
  476.     out of sleep and you can define many other keys to execute other
  477.     programs. If you are running kick2.0- the programs are also added
  478.     to the workbench tools menu. By default the only one added is when
  479.     left amiga and escape is pressed NewShell is executed.
  480.  
  481.     By default "@1922DW in Memory@4045NewShell" note first is DW wakeup
  482.                  \/\/\
  483.                   \ \ \This is the marker between key definitions
  484.                    \ \This is the raw keycode of the normal key
  485.                     \This is the qualifier (special keys down)
  486.  
  487.     Sample Qualifiers:    Sample RawKeys:
  488.        LSHIFT=$01        Esc=$45   F1=$50 to F10=$59
  489.        RSHIFT=$02          `=$00    1=$01 to   \=$0D    BS=$41
  490.        CTRL  =$08        Tab=$42    Q=$10 to   P=$19 to  ]=$1B
  491.        LALT  =$10                   A=$20 to   L=$29 to  '=$2A
  492.        RALT  =$20                   Z=$31 to   M=$37 to  /=$3A
  493.        LAMIGA=$40        Del=$46  Help=$5F  Return=$44 Space=$40
  494.        RAMIGA=$80        Up=$4C Down=$4D Left=$4F Right=$4E
  495.  
  496.                     Keypad RawKeys:
  497.  
  498.                 (=$5A to *=$5D
  499.                 0=$0F    .=$3C   -=$4A   Enter=$43
  500.  
  501.     You can add up to 512 characters of this to launch many programs
  502.     simply by pressing the keys(or selecting them from the tools menu
  503.     in Kick2.0-).   Just follow the format of @ then two digit
  504.     qualifier then two digit keycode then the program to run then
  505.     repeat the format but the first entry must always be the wakeup
  506.     keys for DirWork.
  507.  
  508.  
  509.  
  510.     The SAVE function will modify a DW executable to have the setup
  511.     that you currently have.  You are prompted for the name of the DW
  512.     which would most likey be C:DW.
  513.     BUTTONS/INSTANTACTIONS/MENUOPTIONS/WINDOWSIZE/WINDOWPOSITION/
  514.     POPKEYS are all saved with this command so set up DirWork how you
  515.     like it then use this command.
  516.  
  517. Changing a button:-
  518.  
  519.     You can change a button to make it do something slightly different
  520.     to something totally different.  Just press on the button then go
  521.     to the menu and select "Change last button pressed".   To change an
  522.     instant action you just do the instant action then select "Change
  523.     last button pressed".  You can also just do a binary edit of DirWork
  524.     to change a button or instant action using NewZAP or similar.
  525.     You are then able to edit the button configuration text.  Which
  526.     comprises of:-
  527.  
  528.     "     ,   ,       "
  529.      ||||| ||| |
  530.      |     ||| +------------Arguments for operation.
  531.      |     |||
  532.      |     |||
  533.      |     ||+-------------- Options for certain routines.
  534.      |     ||
  535.      |     ||
  536.      |     ||
  537.      |     ||
  538.      |     ||
  539.      |     ||
  540.      |     |+--------------------- What needs to be selected to operate.
  541.      |     |  F=Selected Files. D=Selected Dirs.
  542.      |     |  B=Selected Files &/or Dirs.
  543.      |     |  A=All files/dirs even if not selected. 
  544.      |     |  0=irrelevent
  545.      |     |
  546.      |     +------------------------ Internal routine the button uses.
  547.      |               A capital letter signifies that the operation does
  548.      |               not require selected files/dirs.  A lower case
  549.      |               hence means the operation should require selected
  550.      |               files/dirs.
  551.      |
  552.      |
  553.      +----------------------------------------  Button Name of 5 Chars
  554.                              This is the text that is displayed inside the
  555.                              button.
  556.  
  557.  
  558. These are the default button options
  559.  
  560. "Instn,nF0,", 
  561. "Print,iF0,",  
  562. "Serch,fF0,",       
  563. "NewZP,uF0,Run >NIL: NewZAP",   
  564. "LharA,aF0,Lharc -m a ", 
  565. "NewSh,N00,NewShell",   
  566. "Info ,I00,",
  567. " Info,I00,",         
  568. "Xoper,N00,Xoper",     
  569. "Commd,N0w,",       
  570. "NewZP,uF0,Run >NIL: NewZAP",   
  571. "Searh,fF0,R",   
  572. "Print,iF0,",   
  573. "Sleep,S00,",
  574.  
  575. "Prefs,N00,Preferences",      
  576. "Prote,kB0,",  
  577. "PlayS,pF0,",       
  578. "MakDi,M00,",           
  579. "HxTyp,hF0,",          
  580. "Delet,dBR,",   
  581. "Move ,mB0,",
  582. " Move,mB0,",         
  583. "Delet,dBR,",  
  584. "HxTyp,hF0,",       
  585. "MakDi,M00,",           
  586. "PlayS,pF0,",          
  587. "Prote,kB0,",   
  588. " VMK ,V00,",
  589.  
  590. "Volms,U00,",         
  591. " Run ,uFR,Run >NIL:", 
  592. "Show ,sF0,",       
  593. "Edit ,uF0,Run >NIL: E",
  594. "Type ,tF0,",          
  595. "Renam,rB0,",   
  596. "Copy ,cB0,",
  597. " Copy,cB0,",         
  598. "Renam,rB0,",  
  599. " Type,tF0,",       
  600. " Edit,uF0,Run >NIL: E",
  601. " Show,sF0,",          
  602. " Run ,uFR,Run >NIL:",  
  603. "Volms,U00,",
  604.  
  605. "WORK:,D00,WORK:",    
  606. "SYS: ,D00,SYS:",      
  607. "DH1: ,D00,DH1:",   
  608. "DH0: ,D00,DH0:",       
  609. "DF1: ,D00,DF1:",      
  610. "DF0: ,D00,DF0:",       
  611. "RAM: ,D00,RAM:",
  612. " RAM:,D00,RAM:",     
  613. " DF0:,D00,DF0:",      
  614. " DF1:,D00,DF1:",   
  615. " DH0:,D00,DH0:",       
  616. " DH1:,D00,DH1:",      
  617. " SYS:,D00,SYS:",       
  618. "WORK:,D00,WORK:",
  619.  
  620. These are the one and two letter buttons between the dir string gadgets
  621.  
  622. "All  ,jAf,",       
  623. "None ,lB0,",           
  624. "CD   ,C00,",
  625. "<<   ,E00,",
  626. "<>SWA,W00,",
  627. ">>   ,E00,",
  628. "CD   ,C00,",       
  629. "None ,lB0,",           
  630. "All  ,jAf,",
  631.   
  632. These are the instant actions taken for various files if you double click the
  633. left button on a file.
  634.  
  635. "MOD. ,uF0,Intuitracker",
  636. ".ARC ,uFp,Arc v",
  637. ".DMS ,uFR,DMS Write",
  638. ".LZH ,uFp,Lharc l",
  639. ".LHW ,uFR,Lhwarp Write 0",
  640. ".PAK ,xFw,",
  641. ".WRP ,uFR,UnWarp",
  642. ".ZIP ,uF0,PkaZIP",
  643. ".ZOO ,uFp,Zoo v",
  644. ".GIF ,uF0,VirtGIF",
  645. ".INFO,000,",
  646. "8SVX ,pF0,",
  647. "ANIM ,uF0,ShowANIM >NIL:",
  648. "ILBM ,sF0,",
  649. "SMUS ,uF0,PlaySMUS >NIL:",
  650. "FTXT ,uF0,",
  651. "Most ,uF0,Most",
  652. "PP20 ,uF0,PPMore",
  653. "Exect,000,",
  654. "Text ,tF0,",
  655. "Binry,hF0,",
  656.  
  657. These are the instant actions taken for various files if you press the right
  658. mouse button on a file.
  659.  
  660. "MOD. ,uF0,Run Intuitracker",
  661. ".ARC ,xFw,Arc xw",
  662. ".DMS ,uFR,DMS Write",
  663. ".LZH ,xFw,Lharc -m -x -r x",
  664. ".LHW ,uFR,Lhwarp Write 0",
  665. ".PAK ,xFw,",
  666. ".WRP ,uFW,UnWarp",
  667. ".ZIP ,uF0,PkaZIP",
  668. ".ZOO ,xFw,Zoo xO//",
  669. ".GIF ,uF0,VirtGIF",
  670. ".INFO,000,",
  671. "8SVX ,uF0,PlaySS >NIL:",
  672. "ANIM ,uF0,ShowANIM >NIL:",
  673. "ILBM ,uF0,Mostra >NIL:",
  674. "SMUS ,uF0,PlaySMUS >NIL:",
  675. "FTXT ,uF0,",
  676. "Most ,uF0,Run >NIL: Most",
  677. "PP20 ,uF0,PPShow",
  678. "Exect,uFR,",
  679. "Text ,uF0,Run >NIL: E",
  680. "Binry,uF0,Run >NIL: NewZAP",
  681.  
  682.  
  683.  
  684. Routine| Example changes and Information
  685. letter | Remember upper case routine letter means selected file(s) related.
  686. ---------------------------------------------------------------------------
  687. D    A simple change would be changing DH1: to DF2: just select the DH1:
  688.     button, go up to change last button pressed and change
  689.     " DH1:,D00,DH1:" to " DF2:,D00,DF2:".
  690.  
  691.     To make a button that gets the directory already in the text gadget
  692.     (instead of just pressing the right mouse button over the gadget)
  693.     "GetDr,D0c,"
  694.  
  695. N    Executes commands.  If you want to execute a program and don't
  696.     want the selected files to be added to the command.
  697.     You must add CTRL-J EndCLI to your command if you use a option
  698.     that opens a window and you want it to automatically close.
  699.  
  700.     Options:-
  701.  
  702.        w if you want a window to open for the output.
  703.        p if you want a window to open for the output and waits for you
  704.          to press a key before it closes.
  705.        R if you want a requester so you can edit the command before
  706.          it is executed.
  707.        W if you want a requestor then a window to open for the output.
  708.        P if you want a requestor then a window that waits for a key.
  709.        0 means no window or requester.
  710.  
  711.     Examples:-
  712.  
  713.     "Prefs,N00,Preferences"  Bring up 1.2/1.3 preferences.
  714.                              No output window is opened.
  715.  
  716.     "Avail,N0p,AvailJEndCLI"   Show available memory in a window.
  717.                                Then automatically close that window
  718.                                after the user presses a key (or clicks
  719.                                on the close gadget with Kick2.0-).
  720.                                    Note the J is CTRL-J
  721.  
  722.     "Avail,N0w,List"   List a directory in a output window that stays
  723.                        open until the user enters EndCLI (or clicks
  724.                        on the close gadget with Kick2.0-).
  725.  
  726.     "DiskC,N0w,DiskCopy DF0: TO DF0:JEndCLI"  Diskcopy DF0: to DF0:
  727.                                               opening a window for
  728.                                               the output that auto
  729.                                               closes when the Diskcopy
  730.                                               is finished.
  731.                                                   Note the J is CTRL-J
  732.  
  733. M    The Makedir function can be given a filename which it will copy
  734.     to create a icon for the directory.  All you have to do is give
  735.     it the filename of the icon you want it to create.
  736.     "MakDr,M00,sys:DefaultDraw.info"
  737.  
  738.  
  739. P    To create a parent button if you don't like going to the far
  740.     left/right of the directory text and pressing the left button.
  741.     "Paren,P00,"
  742.  
  743. R    To create a root button if you don't like going to the far
  744.     left/right of the directory text and pressing the right button.
  745.     "Root ,R00,"
  746.  
  747.  
  748. j    To make a all button select dirs as well as files.
  749.     Change "All  ,jAf," to "All  ,jAb,"
  750.  
  751.  
  752. d    To make a delete button that doesn't request you when you delete a
  753.     non empty dir.
  754.     Change "Delet,dBR," to "Delet,dB0,"
  755.  
  756. c    To make a copy button clone the file note, protection and date.
  757.     BytesFree for the source/destination is updated after a copy.
  758.     "CCopy,cBc,"
  759.  
  760. m    To make a move button clone the file note, protection and date.
  761.     "CMove,mBc,"
  762.  
  763. u    The u internal routine is one of the most usefull it will execute
  764.     the text in the argument part of the button config with any any
  765.     file/dirnames selected.  If you want the button to operate on
  766.     selected files and directories use the B middle letter.  If you
  767.     want it just to operate on selected files use F and if you just
  768.     want it to operate only on selected Dirs use D.   Note the u
  769.     command automatically adds JEndCLI (where J is CTRL-J) to commands
  770.     that use an option that opens a window
  771.  
  772.     Options:-
  773.  
  774.        w if you want a window to open for the output.
  775.        p if you want a window to open for the output and waits for you
  776.          to press a key before it closes.
  777.        R if you want a requester so you can edit the command before
  778.          it is executed.
  779.        W if you want a requestor then a window to open for the output.
  780.        P if you want a requestor then a window that waits for a key.
  781.        0 means no window or requester.
  782.  
  783.     An example of using the u routine is the edit button and right mouse
  784.     instant operation on text files:- " Edit,uF0,Run >NIL: E"
  785.     To change to path for the editor from E to c:Ed just select the edit
  786.     button, go up to change last button pressed and change to
  787.     " Edit,uF0,Run >NIL: c:Ed"
  788.     Note an output window is not needed hence the 0 as the option.
  789.  
  790.     To change the double click on a text file to use another text viewer
  791.     instead of the default internal type.  After you double click a
  792.     text file & select change last button pressed change
  793.     "Text ,tF0," to "Text ,uF0,ViewerName".
  794.  
  795.     To make a button that uses DOS's list command on selected files and
  796.     dirs, and shows the output in a window than stays open until the
  797.     user presses a key (or clicks the close gadget with Kick2.0-).
  798.     "List ,uBp,List"
  799.  
  800.     To make a button that uses DOS's Execute command to execute script
  801.     files, with an output window open while the command is executing.
  802.     "Execu,uFw,Execute"
  803.  
  804.     To make a button that uses DOS's FileNote command to change the
  805.     FileNote of a file in a requester.
  806.     "Execu,uFR,FileNote"
  807.  
  808.  
  809. x    Is like the u command except that the other file list
  810.     is CD'ed before the command is executed.  It is used for the extract
  811.     commands for .lzh files and the like so that files produced go to
  812.     the destination directory and not the source one.
  813.     The destination directory is read in after this button is finished.
  814.  
  815. b    Is the routine which displays the FileNote/protection bits so
  816.     "FBits,bB0," would create a button for it instead of going to the
  817.     far right or left of the file/dir.
  818.  
  819.  
  820. Most people will make small changes to the button configurations if any, the
  821. simplest changes are the changing of the button text and the arguments.
  822. There are heaps more configuration changes & new buttons you could make!
  823. If you are a registered user just describe what sort of button you would
  824. like configured and I will give you the button configuration text for it
  825. if it is possible.
  826.  
  827.  
  828. Bye,
  829.     Chris Hames (Available for any Amiga work)
  830.  
  831.